// Array.from()
// Array.from方法用于将两类对象转为真正的数组：
// 类似数组的对象（array-like object）和可遍历（iterable）的对象（包括ES6新增的数据结构Set和Map）。

function fm() {
    let arrayLike = {
        '0': 'a',
        '1': 'b',
        '2': 'c',
        length: 3
    };
    // ES5的写法
    var arr1 = [].slice.call(arrayLike); // ['a', 'b', 'c']
    console.log(arr1);
    // ES6
    let arr2 = Array.from(arrayLike);
    console.log(arr2);
    // 实际应用中，常见的类似数组的对象是DOM操作返回的NodeList集合，以及函数内部的arguments对象。Array.from都可以将它们转为真正的数组
    // NodeList对象
    let ps = document.querySelectorAll('p');
    Array.from(ps).forEach(function (p) {
        console.log(p);
    });
    // arguments
    function fo() {
        var args = Array.from(arguments);
        console.log(args);
    }

    // 只要是部署了Iterator接口的数据结构，Array.from都能将其转为数组。
    Array.from('hello')
    // ['h', 'e', 'l', 'l', 'o']
    let namesSet = new Set(['a', 'b'])
    Array.from(namesSet) // ['a', 'b']
    // 上面代码中，字符串和Set结构都具有Iterator接口，因此可以被Array.from转为真正的数组。

    // 扩展运算符（...）也可以将某些数据结构转为数组。
    // arguments对象
    function foo() {
        var args = [...arguments];
    }

    // 扩展运算符背后调用的是遍历器接口（Symbol.iterator）,如果一个对象没有部署这个接口，就无法转换。Array.from方法则是还支持类似数组的对象。所谓类似数组的对象，本质特征只有一点，即必须有length属性。因此，任何有length属性的对象，都可以通过Array.from方法转为数组，而此时扩展运算符就无法转换。

    // 对于还没有部署该方法的浏览器，可以用Array.prototype.slice方法替代。

    const toArray = (() =>
        Array.from ? Array.from : obj => [].slice.call(obj))();
    // Array.from还可以接受第二个参数，作用类似于数组的map方法，用来对每个元素进行处理，将处理后的值放入返回的数组。

    // 下面的例子是取出一组DOM节点的文本内容。

    let spans = document.querySelectorAll('span.name');
    // map()
    let names1 = Array.prototype.map.call(spans, s => s.textContent);
    // Array.from()
    let names2 = Array.from(spans, s => s.textContent)

}


// Array.of方法用于将一组值，转换为数组。
function of() {
    console.log(Array.of(1, 2, 3));
    // 这个方法的主要目的，是弥补数组构造函数Array()的不足。因为参数个数的不同，会导致Array()的行为有差异。
    // Array方法没有参数、一个参数、三个参数时，返回结果都不一样。只有当参数个数不少于2个时，Array()才会返回由参数组成的新数组。参数个数只有一个时，实际上是指定数组的长度。
    // Array.of基本上可以用来替代Array()或new Array()，并且不存在由于参数不同而导致的重载。它的行为非常统一。

    // Array.of总是返回参数值组成的数组。如果没有参数，就返回一个空数组。
}

// copyWithin()
function cwi() {
    // 数组实例的copyWithin方法，在当前数组内部，将指定位置的成员复制到其他位置（会覆盖原有成员）
    // 然后返回当前数组。也就是说，使用这个方法，会修改当前数组。
    // Array.prototype.copyWithin(target, start = 0, end = this.length)

    /**
     target（必需）：从该位置开始替换数据。
     start（可选）：从该位置开始读取数据，默认为0。如果为负值，表示倒数。
     end（可选）：到该位置前停止读取数据，默认等于数组长度。如果为负值，表示倒数
     */
    [1, 2, 3, 4, 5].copyWithin(0, 3); // [4, 5, 3, 4, 5]

}

// array.find(), array.findIndex()
function find() {
    // 数组实例的find方法，用于找出第一个符合条件的数组成员。它的参数是一个回调函数，所有数组成员依次执行该回调函数，直到找出第一个返回值为true的成员，然后返回该成员。
    // 如果没有符合条件的成员，则返回undefined。

    [1, 4, -5, 10].find((n) => n < 0); // -5

    // 上面代码找出数组中第一个小于0的成员。

    [1, 5, 10, 15].find(function (value, index, arr) {
        return value > 9;
    }); // 10
    // 上面代码中，find方法的回调函数可以接受三个参数，依次为当前的值、当前的位置和原数组。

    // 数组实例的findIndex方法的用法与find方法非常类似，返回第一个符合条件的数组成员的位置，如果所有成员都不符合条件，则返回-1。
    [1, 5, 10, 15].findIndex(function (value, index, arr) {
        return value > 9;
    });// 2

    //  这两个方法都可以接受第二个参数，用来绑定回调函数的this对象。
    // 另外，这两个方法都可以发现NaN，弥补了数组的IndexOf方法的不足。

    [NaN].indexOf(NaN);// -1
    [NaN].findIndex(y => Object.is(NaN, y)); // 0
    // 上面代码中，indexOf方法无法识别数组的NaN成员，但是findIndex方法可以借助Object.is方法做到。
}

function fill() {
    console.log([1, 2, 3].fill(7));
    console.log(Array(3).fill(7));
    // fill方法用于空数组的初始化非常方便。数组中已有的元素，会被全部抹去。
    // fill方法还可以接受第二个和第三个参数，用于指定填充的起始位置和结束位置。
    ['a', 'b', 'c'].fill(7, 1, 2)
    // ['a', 7, 'c']
    // 上面代码表示，fill方法从1号位开始，向原数组填充7，到2号位之前结束。
}


// 数组实例的entries()，keys()和values()
function ekv() {
    // ES6提供三个新的方法——entries()，keys()和values()——用于遍历数组。
    // 它们都返回一个遍历器对象（详见《Iterator》一章），可以用for...of循环进行遍历，
    // 区别是keys()是对键名的遍历、values()是对键值的遍历，entries()是对键值对的遍历。

    for (let index of ['a', 'b'].keys()) {
        console.log(index);
    }
    // 0
    // 1
    for (let elem of ['a', 'b'].values()) {
        console.log(elem);
    }
    // 'a'
    // 'b'
    for (let [index, elem] of ['a', 'b'].entries()) {
        console.log(index, elem);
    }
    // 0 "a"
    // 1 "b"

    // 如果不使用for...of循环，可以手动调用遍历器对象的next方法，进行遍历。
    let letter = ['a', 'b', 'c'];
    let entries = letter.entries();
    console.log(entries.next().value); // [0, 'a']
    console.log(entries.next().value); // [1, 'b']
    console.log(entries.next().value); // [2, 'c']
}

// 数组实例的includes()
function includes() {
    // Array.prototype.includes方法返回一个布尔值，表示某个数组是否包含给定的值，
    // 与字符串的includes方法类似。该方法属于ES7，但Babel转码器已经支持。
    console.log([1, 2, 3].includes(2));
    // 该方法的第二个参数表示搜索的起始位置，默认为0。如果第二个参数为负数，则表示倒数的位置，
    // 如果这时它大于数组长度（比如第二个参数为-4，但数组长度为3），则会重置为从0开始。

    // 在之前，都是使用数组的indexOf方法检查是否包含某个值
    // indexOf方法有两个缺点，一是不够语义化，它的含义是找到参数值的第一个出现位置，所以要去比较是否不等于-1，表达起来不够直观。
    // 二是，它内部使用严格相当运算符（===）进行判断，这会导致对NaN的误判。
    [NaN].indexOf(NaN); // -1
    // includes 使用的是不同的判断方法
    [NaN].includes(NaN); // true
    //
    const contains = (() =>
        Array.prototype.includes
            ? (arr, value) => arr.includes(value)
            : (arr, value) => arr.some(el => el === value))();
    contains(["foo", "bar"], "baz"); // => false

    // 另外，Map和Set数据结构有一个has方法，需要注意与includes区分。

    // Map结构的has方法，是用来查找键名的，比如Map.prototype.has(key)、WeakMap.prototype.has(key)、Reflect.has(target, propertyKey)。
    // Set结构的has方法，是用来查找值的，比如Set.prototype.has(value)、WeakSet.prototype.has(value)。

}

// 数组的空位
function empty() {
    // 数组的空位指，数组的某一个位置没有任何值。比如，Array构造函数返回的数组都是空位。
    Array(3) // [, , ,]
    // 上面代码中，Array(3)返回一个具有3个空位的数组。
    // 空位不是undefined，一个位置的值等于undefined，依然是有值的。空位是没有任何值，in运算符可以说明这一点。
    0 in [undefined, undefined, undefined] // true
    0 in [, , ,] // false
    // 上面代码说明，第一个数组的0号位置是有值的，第二个数组的0号位置没有值。

    /**
     ES5对空位的处理，已经很不一致了，大多数情况下会忽略空位。

     forEach(), filter(), every() 和some()都会跳过空位。
     map()会跳过空位，但会保留这个值
     join()和toString()会将空位视为undefined，而undefined和null会被处理成空字符串。
     */

    /**
     // forEach方法
     [,'a'].forEach((x,i) => console.log(i)); // 1

     // filter方法
     ['a',,'b'].filter(x => true) // ['a','b']

     // every方法
     [,'a'].every(x => x==='a') // true

     // some方法
     [,'a'].some(x => x !== 'a') // false

     // map方法
     [,'a'].map(x => 1) // [,1]

     // join方法
     [,'a',undefined,null].join('#') // "#a##"

     // toString方法
     [,'a',undefined,null].toString() // ",a,,"
     */

        // ES6则是明确将空位转为undefined。
        // Array.from方法会将数组的空位，转为undefined，也就是说，这个方法不会忽略空位。
    Array.from(['a', , 'b']); // [ "a", undefined, "b" ];

}

// 尽量避免出现空位
console.log(Array(3));
console.log(new Array(3));
// 上面都是空位
